home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1994 November / macformat-018.iso / Utility Spectacular / Disk / Find Stuff ƒ / Find Stuff About next >
Encoding:
Text File  |  1993-12-24  |  12.0 KB  |  290 lines  |  [ttro/ttxt]
  1.                     Find Stuff    v 1.0.4
  2.                 The Ultimate Find Program
  3.                 
  4.                 
  5.                     By: Dave Sugar
  6.                     udsugar@mcs.drexel.edu                
  7.                 
  8.  
  9. Registration:
  10.     Find Stuff is a shareware product and you are encouraged to
  11.     register.  This is a very simple procedure in this case.  All you 
  12.     have to do to register is send a post card with something to
  13.     show me how much you like the program.
  14.  
  15.     Send registration cards to:
  16.         Dave Sugar
  17.         3718 Norburn Rd
  18.         Randallstown, MD  21133 USA
  19.  
  20.             
  21. What is Find Stuff?
  22.     Find Stuff is an application that will find your files.  It is
  23.     similar to the Finder's find command but more sophisticated and
  24.     versatile.  You ask, "Why should I use this instead of the finder
  25.     find then?"  Well, because with Find Stuff you can search by 
  26.     multiple parameters at one time and it is faster than the
  27.     finder's find.  You can search for files by partial file name,
  28.     label, type, creator, date created and date modified or any
  29.     combination of the parameters.
  30.  
  31.     Find Stuff is a shareware product, please see the end of this file
  32.     for more info on distribution and registration.
  33.  
  34.  
  35. How to use Find Stuff?
  36.     I hope that I have designed the interface to Find Stuff so that it
  37.     feels very natural and is easy to understand.  (In which case you
  38.     shouldn't even need to read this).  Anyway, when you first launch
  39.     Find Stuff it will bring up a window with buttons and a list of
  40.     mounted volumes.
  41.  
  42.     You choose the volumes you want to search by selecting the
  43.     volume name from the list in the top right of the dialog.  You can
  44.     use the standard selection keys to select the volumes.  Shift
  45.     click to make a continuous selection or Command click to just
  46.     toggle the selection of the current item.  You can choose any
  47.     number of volumes to search.
  48.  
  49.     Then you choose the parameters you want to use to search.  You
  50.     do this by first clicking on the icon.  Once the icon has been
  51.     clicked the 'Parameters' button will be enabled so you can set
  52.     the parameters of that item.  
  53.  
  54.     Once you have selected all the items you want to search by and
  55.     filled in all the parameters for each of them you press the 'Find' 
  56.     button and that will begin the search.
  57.  
  58.     When the search begins a dialog will appear to keep you up to 
  59.     date on the search.  It will give you a list of the files that have
  60.     been found and it will tell you which volume is currently being
  61.     searched. While the search is going on you can click on any of the
  62.     files that have been found and it will show you the path, type,
  63.     and creator of the file.  If you then click 'Show File' the Finder
  64.     will come into the foreground and show you that file.
  65.  
  66.  
  67. So you don't like something?
  68.     Well, first off, check out the Preferences menu.  Many of the
  69.     things that some of my beta testers have complained about I
  70.     have already made into preferences.  Again, these should be
  71.     pretty much self explanatory but I will go into a little detail
  72.     about each of them.   
  73.  
  74.     'When launched Open'- when checked will automatically open one
  75.     of the parameter dialogs when the Find Stuff is launched.  The
  76.     most common use for this is if you usually search for files by
  77.     name.  You would click the 'Name' radio button and that dialog
  78.     would automatically be opened every time the application is
  79.     launched.
  80.  
  81.     'Quit when Main Window is closed'- this will automatically quit
  82.     from Find Stuff when you close the main window.
  83.  
  84.     'Open Parameter Dialog when selected'- will automatically open
  85.     the parameter dialog when you click on one of the icons, instead
  86.     of waiting for you to click on the parameter button.  I made this
  87.     a preference because I don't really like the feel of having them
  88.     automatically come up when the icon is clicked, but I see the
  89.     need to reduce the number of mouse clicks.
  90.  
  91.     'Enter in Parameter dialog begins Find'- this is a nice feature
  92.     that was mentioned.  When you are in a parameter dialog if this
  93.     is checked and you press the enter key (as opposed to just the
  94.     return key to close the dialog) then the find will automatically
  95.     start instead of you having to click the Find button from the
  96.     main window.
  97.  
  98.     'Show found invisible files'- this option will allow you to find
  99.     files that are normally invisible on the Macintosh file system.
  100.     You normally won't need the option unless you are looking for a
  101.     file that you normally can't see.  When an invisible file is found
  102.     Find Stuff will show you the path of the file, but you can not
  103.     select it in the finder.
  104.  
  105.     'Default Volume Selection'- tells Find Stuff what volumes to be
  106.     selected automatically when you first launch it.  If you choose
  107.     'All Volumes' each time Find Stuff is launched all mounted
  108.     volumes will be marked for searching.  'Startup Volume' will
  109.     only select the boot drive to be searched.  'No Volumes' will not
  110.     mark any volumes for searching.  'Local Volumes' will only mark
  111.     volumes on this computer for searching, it won't mark Network
  112.     volumes.
  113.  
  114.     The last thing that you can change is the list of file types and
  115.     creators in the type and creator parameter dialogs.  To do this
  116.     you go to the 'Type/Creator' selection from the Preferences
  117.     menu.  There it gives you a scrolling list of titles and the type
  118.     and creator for each item.  You can add and remove items to
  119.     make a custom list that contains the files that you regularly
  120.     use.
  121.  
  122.     If you have any ideas that you think would make some good 
  123.     additions to Find Stuff feel free to mail them to me and I will
  124.     see what I can do about make additions.
  125.  
  126.  
  127. A bit more about Searching:
  128.     If you want some more info about exactly what you can search
  129.     by then read this section.  
  130.  
  131.     The Name parameters allow you to search by name.  You type in a
  132.     partial file name and then you can choose whether the file you
  133.     are searching for should just contain the partial text, whether
  134.     the name should begin or end with this partial text or if this
  135.     should be the entire file name to search for.  So far this doesn't
  136.     use regular expressions (though that is an idea of something to
  137.     add).
  138.     
  139.     The Label parameters allow you to search by label.  You just
  140.     choose the label which you want to search by.  Right now you can
  141.     only search by one label at a time.  I don't think there is a way to
  142.     all you to search for more than one label at a time, but that is
  143.     something that I thought of adding in, I will see what I can come
  144.     up with for a future version.
  145.  
  146.     The Date Created parameters allow you to search by the creation 
  147.     date of the file.  You give it a date and tell it to look on this
  148.     date, before or after this date.
  149.  
  150.     The Date Modified parameters allow you to search by the date
  151.     the file was last modified.  You give it a date and tell it to look
  152.     on this date, before or after this date.
  153.  
  154.     The Type parameters allow you to search by file type.  You can
  155.     either type in the 4 character type or use the pop-up menu to 
  156.     quickly select a file type.  The menu is completely customizable
  157.     from the Preferences menu the 'Type/Creator' selection.
  158.  
  159.     The Creator parameters allow you to search by the file creator.
  160.     You can either type in the 4 character creator or use the pop-up
  161.     menu to quickly select a creator.  This menu is also completely
  162.     customizable from the Preferences menu the 'Type/Creator'
  163.     selection.
  164.  
  165.     The last thing is the 'Ignore System Folder' button.  When this
  166.     is selected the search will ignore any matches that happen to be
  167.     in the System Folder.  This can be useful if you are looking for
  168.     someting that has a bunch of matches in the System Folder that
  169.     you really don't care about.
  170.     
  171.  
  172. Hidden Features:
  173.     These feature are around just to make navigating around easier 
  174.     and so you can do things quickly without a lot of button clicking.
  175.     
  176.     First option is if you hold down the option key while you click
  177.     on the 'Show File' button in the window that has the list of
  178.     found items this will so you the selected files and quit from
  179.     Find Stuff, leaving the Finder in the foreground.
  180.     
  181.     Second thing is that in the list of found items you can select
  182.     more that one item and when you press the 'Show File' button it
  183.     will show all of the files and they will all be selected.
  184.  
  185.  
  186. Technical Jargon:
  187.     The way that I have done the search is to use the Macintosh
  188.     low-level file function PBCatSearch.  This allows me to do the
  189.     very fast search for the file and it is a very flexible function in
  190.     which I can specify many different parameters to search for.
  191.     Once I find a file with PBCatSearch is go through a secondary
  192.     filter to check for everything else to make sure that I have an
  193.     actual match.  
  194.  
  195.     Find Stuff will only search on volumes that support the 
  196.     PBCatSearch function if a volumes does not support this then
  197.     that volume will not be listed in the volumes that are
  198.     searchable. So far the only volume that I know of that does not
  199.     support PBCatSearch is a unix CAP mounted volume.  But I'm sure
  200.     that there are others.
  201.  
  202.     Find Stuff's user interface was developed using Harmony,
  203.     published by Cedrus Corporation.  For more information, contact
  204.     Cedrus at 1-800-233 7871, or harmony@cedrus.com.
  205.  
  206.  
  207. Bugs:
  208.     If you find any bugs in the program please inform me of what you
  209.     found, your system specifcation, what type of volume you were 
  210.     trying to serach, and how I can duplicate the error.  
  211.     
  212.  
  213. Distribution:
  214.     Find Stuff must be distributed for free and in it's entirety 
  215.     (Find Stuff application and this README file).  It may be placed
  216.     on public and private BBSes, internet, commercial services 
  217.     (like CompuServe, Genie, America Online), and shareware
  218.     distribution disks as long as there is no extra charge for the
  219.     software, just the normal fee for the service.
  220.  
  221.     If you are not sure about your service contact the author via
  222.     e-mail or postal mail at above address.
  223.  
  224.  
  225. Very Special Thanks:
  226.     I would like to thank all of the following people for their ideas,
  227.     suggestions and time.  They helped me make Find Stuff as good
  228.     as it is.  I think this is everybody, if I forgot someone I am sorry
  229.     but I am just tired and this has been a very long file to write.
  230.     
  231.         Scott DeLucia     -- interface ideas
  232.         Mike Flynn         -- beta testing and general ideas
  233.         Jim Gilsinn     -- beta testing, ideas and icons
  234.         Stuart Harper     -- ideas and beta testing
  235.         Joe Hicks         -- finding bugs
  236.         Arion Lawrence     -- beta testing and ideas
  237.         Mike Meystel    -- final beta testing
  238.         Dave Slotter     -- finding that bug with unmounting volumes
  239.         Duncan Widman     -- beta testing and finding bugs
  240.         Amen Zwa        -- for installing CAP so I could test it
  241.         
  242.         
  243.  
  244. Updates:
  245.     Version 1.0.4:
  246.         * Minor bug fixed which would crash when 'Show Inivisibles' option
  247.              was off and a match was made that was a volume.  It would go
  248.              into an infinite recursive loop.
  249.  
  250.   Version 1.0.3:
  251.         * Fixed bug with "At Ease".  When "At Ease" was running and the
  252.           Finder was not if the 'Show File' was clicked the computer would
  253.           lock up.  Now if the Finder is not running the 'Show File' 
  254.           button is not shown.
  255.           
  256.         * Fixed bug when searching by file TYPE or CREATOR only the last
  257.           two characters of the TYPE or CREATOR were being checked instead
  258.           of all four.  Now searching by TYPE and CREATOR works correctly.
  259.           
  260.         * Added in the Searching Dialog it shows the file creation date
  261.           last modification date and file size.
  262.           
  263.         * Fixed bug where Find Stuff would crash on Macintosh Quadra
  264.           computers.  It would mainly crash when the 'Pause' or 'Resume'
  265.           button was pressed.  
  266.           
  267.         * Added this list of what has been updated between different
  268.              versions.
  269.  
  270.     Version 1.0.2
  271.         * Fixed bug where trying to add a file in the Type/Creator Dialog
  272.           with a '^' or '~' would have wierd results.
  273.           
  274.         * Added display of the number of files that have been found.
  275.         
  276.         * Minor interface change.  When a parameter Icon is clicked and
  277.           the default is to automaticly show the parameters dialog, the
  278.           corresponding 'parameter' button is flashed.
  279.             
  280.     Version 1.0.1 (never released)
  281.         * Fixed bug that would cause crash on Macs with out Color QuickDraw.
  282.  
  283.         * Fixed bug with the 'Show Invisible' option that would cause files
  284.           to be displayed even if they were not a total match by all the
  285.           search parameters.  This effected the 'Ignore System Folder' option
  286.           and searches with multiple parameters.
  287.         
  288.     Version 1.0 (Inital release)
  289.         * If you find a version older that 1.0 please just throw it away!!
  290.